home *** CD-ROM | disk | FTP | other *** search
/ Now That's What I Call Games 1 / Now That's What I Call Games (1993)(Multi Media Machine)[!][CD32-CDTV].iso / shareware / chess / ins.doc < prev    next >
Text File  |  1993-09-10  |  10KB  |  338 lines
  1. Amiga GnuChess Version 1.0
  2.  
  3. Amiga-related  portions  Copyright  (c)  1992
  4. Martin W. Scott.  All  other  code  Copyright
  5. (c) 1986-92 Free  Software  Foundation.  This
  6. program  is  governed  by   the   terms   and
  7. conditions of the GNU Public License. A  copy
  8. should have come with this  distribution.  In
  9. that license, it  is  made  clear  that  this
  10. program comes with absolutely no warranty.
  11.  
  12. Okay,  that's  the   legal/copyright     guff
  13. over. This is a port  of  GNU  Chess  to  the
  14. Amiga. It  contains  a  nice  graphical  user
  15. interface (menus, use mouse  to  move  pieces
  16. etc.) along the same lines as that  done  for
  17. another chess program on Fish disk  205.  The
  18. advantages of this program over that one  are
  19. that   GNU   Chess   is   a   much   stronger
  20. chess-playing program, and that  the  GUI  of
  21. this  program  was  designed  with  Workbench
  22. 2.0(+) in mind.  Another  advantage  is  that
  23. the older chess program crashes on my  system
  24. (chais  pas  pourquoi)  but  Amiga   GnuChess
  25. doesn't. From now on, I shall refer to  Amiga
  26. GnuChess simply as AGC.
  27.  
  28.  
  29. Starting AGC
  30. ------------
  31. Firstly, AGC needs a few files  in  order  to
  32. work. These should be located  in  the  misc/
  33. directory of where the program  was  started.
  34. You will need at least 1 megabytes of  memory
  35. to run AGC.
  36.  
  37. You may start AGC from the Workbench or  CLI.
  38. A  stack  of  20000  should  be   more   than
  39. sufficient for AGC. When  started,  a  screen
  40. will be opened, and after a short delay,  you
  41. will be presented with a menu from  which  to
  42. choose  a  playing  level.  Which  level  you
  43. choose depends on how fast  your  machine  is
  44. and how good you are.
  45.  
  46.  
  47. Playing a move
  48. --------------
  49. Once the level is  selected,  the  chessboard
  50. will be drawn on the screen.  AGC  will  then
  51. read in the openings  library  if  available,
  52. and prompt you to move. You may type the move
  53. in explicit algebraic notation (e.g. e2e4) or
  54. abbreviated notation (e.g. e4, Nf3,  cd),  or
  55. if you are smart, use the mouse. When  typing
  56. in    moves    in    abbreviated    notation,
  57. piece-letters must be entered in  upper-case.
  58. This is to  stop  ambiguities  like  b5b4  ==
  59. B5b4: the former says move the piece on b5 to
  60. b4, whilst the latter says move the bishop on
  61. row 5 to b4.
  62.  
  63. I have opted for a drag-approach when   using
  64. the mouse; click down on the left-button over
  65. the piece you want  to  move,  and  move  the
  66. mouse  to  the  destination  square,   whilst
  67. holding the  left-button.  Then  release  the
  68. left-button. If the move is valid, it will be
  69. played,  otherwise  an  error  message   will
  70. appear to the right of the  board.  To  abort
  71. playing a move, either play an illegal  move,
  72. or release the left-button over the piece you
  73. are moving.
  74.  
  75. You can use the mouse for all  valid    moves
  76. except pawn promotion; due  to  the  way  the
  77. Amiga driver was implemented (see below)  you
  78. have to type in  such  moves  using  explicit
  79. algebraic  notation,   specifying   what   to
  80. promote to, e.g. b7b8q to get a queen. I  may
  81. change things to allow use of the mouse,  but
  82. don't hold your breath.
  83.  
  84. Once you have made your move, AGC will  think
  85. a little, then respond.
  86.  
  87.  
  88. The Menus
  89. ---------
  90. A brief overview:
  91.  
  92. Project Menu:
  93. -------------
  94. New game: Starts a new game.  resets   clocks
  95. and some options.
  96.  
  97. Load game: Loads a  previously  saved   game.
  98. If you  have  reqtools.library  installed  on
  99. your system, a file requester will pop up.
  100.  
  101. Save game: Saves the current position     for
  102. subsequent loading. Take a peek  at  a  saved
  103. game-file to see what stuff is  output.  Note
  104. that no changes have been made to the  format
  105. for the Amiga version of GNU Chess.
  106.  
  107. Create listing:  Outputs  a  listing    file.
  108. Not really useful  unless  debugging  options
  109. have been compiled in to AGC. They haven't.
  110.  
  111. Edit board:     See below.
  112.  
  113. Help: Brings up a help screen. Press a key to
  114. get back to the game.
  115.  
  116. About: Brings up a requester  telling  you  a
  117. few things about AGC.
  118.  
  119. Quit: Exit AGC.
  120.  
  121. Settings Menu:
  122. --------------
  123.  
  124. Select Level:  Brings  up  the  playing-level
  125. menu you saw when you started AGC.
  126.  
  127. Change   colours:   Brings   up   a   palette
  128. requester, only if you have
  129.  
  130. reqtools.library installed.
  131.  
  132. Save colours: Save your colour preferences to
  133. GNUCHESSDIR (or the default directory).
  134.  
  135. Toggles Menu:
  136. -------------
  137.  
  138. Reverse   board:   Changes   orientation   of
  139. chessboard.
  140.  
  141. Coordinates:    Draw    coordinates    around
  142. chessboard.
  143.  
  144. Show thinking: Shows best line found,    plus
  145. number of positions (nodes) looked at, and  a
  146. nodes/second count.
  147.  
  148. Random play: Slightly randomise the moves AGC
  149. plays.
  150.  
  151. Beep after move:  Produce  an  audible   beep
  152. after AGC has played its move.
  153.  
  154. Move Menu:
  155. ----------
  156. Go: Tells computer to play a move.
  157.  
  158. Undo half-move: Take back last move.
  159.  
  160. Undo whole-move: Take back last   move,   and
  161. one before that.
  162.  
  163. Switch sides: Switch sides with computer.
  164.  
  165. Input both sides: Lets you play  both   sides
  166. until you 'switch'.
  167.  
  168. Redraw  board:  If  screen  becomes   garbled
  169. (can't think why) select this item.
  170.  
  171. Hint: Ask for a move suggestion.  Of  varying
  172. quality
  173.  
  174. NOTE: Drag-selection of  menu  items  is  not
  175. supported; this is because of the  nature  of
  176. the interface between GNU Chess and the Amiga
  177. driver. Sorry.
  178.  
  179. There are a few other things you can do  (see
  180. the help  page)  but  the  menus  cover  most
  181. things.   Consult   other    (standard    GNU
  182. distribution) documents for details.
  183.  
  184.  
  185. Editing the board
  186. -----------------
  187. Sorry, but you can't use the mouse for  this.
  188. A little menu appears  at  the  side  of  the
  189. board. It's use is almost  self  explanatory.
  190. To put a piece on the board, type it's letter
  191. and the square coordinates, e.g. pd6  puts  a
  192. pawn on the d6 square (its colour depends  on
  193. what the menu shows).
  194.  
  195.  
  196. Compiling AGC
  197. -------------
  198. I've used SAS/C 5.10a to compile  AGC.  While
  199. this  is  a  fairly   reliable   and   robust
  200. compiler, it does have  problems  with  large
  201. UNIX applications. Version 6 may or  may  not
  202. overcome the difficulties outlined below, but
  203. I don't have it yet.
  204.  
  205. The main philosophy of the Amiga stuff  added
  206. was that the generic GNU  Chess  code  remain
  207. unaltered, so the Amiga routines  were  added
  208. to be seamless to the program. This  has  the
  209. advantage that future versions of  GNU  Chess
  210. may hopefully be adapted easily to the  Amiga
  211. driver.
  212.  
  213. Changes Made
  214. ------------
  215. Firstly, transposition tables are  out.  When
  216. compiled  in,  the   search   routine   would
  217. sometimes  score  a  line  as   about   20000
  218. (abs(score) should be < 10000),  thus  making
  219. it think it has found a  really  great  move.
  220. Mostly it wont be. This is surely not  a  bug
  221. with GNU Chess, but with the compiler -- such
  222. a whopper would never have got out...
  223.  
  224. Secondly,  Easy  mode  is  permanently    on,
  225. since SAS/C doesn't have the full  complement
  226. of signals and because it would be  difficult
  227. to implement with  the  Amiga  driver.  (Easy
  228. mode off means that the computer thinks while
  229. you do.)
  230.  
  231. If you are going to compile  AGC    yourself,
  232. don't use  optimisation,  since  it  produces
  233. incorrect code (in this  program  anyway).  I
  234. have also compiled  with  no  stack  checking
  235. (I'm told its buggy) to  speed  things  up  a
  236. bit, so stack size should be set large enough
  237. (20K seems sufficient).
  238.  
  239. On the subject of stack sizes, LC1  needs   a
  240. biggish stack (about 30000 bytes) to  compile
  241. dspcom.c.
  242.  
  243. I've made very few changes to the  basic  GNU
  244. Chess  code,  and  those  I  have  made   are
  245. governed  by  #ifdefs  mostly.  The  original
  246. makefile has taken  a  bit  of  a  hammering,
  247. though. The amidsp.c  is  based  on  nuxdsp.c
  248. (fancy curses) of the standard  distribution.
  249. I have not included that or any  other  files
  250. that are unnecessary to  generate  the  Amiga
  251. version of GNU  Chess.  Other  support  stuff
  252. (for e.g. postscript printing of  games)  are
  253. available from the F.S.F.  (and  various  ftp
  254. sites around the world).
  255.  
  256. All  Amiga-specific   routines   are   in   a
  257. subdirectory (amiga/) in the src/  directory.
  258. The  graphics  were  made   in   dpaint   and
  259. converted using iff2c from an old fish disk.
  260.  
  261. I  decided  to  use  reqtools.library     (of
  262. which Nico François holds  copyright)  rather
  263. than asl.library. This is because reqtools is
  264. better, and  I  needed  it  for  the  palette
  265. requester anyway. AGC runs without it, but  I
  266. imagine  that  most  aware  users   have   it
  267. installed.
  268.  
  269.  
  270. Credits
  271. -------
  272. All credits mentioned here relate   only   to
  273. the Amiga portions of  the  source.  See  the
  274. standard distribution files for full credits.
  275.  
  276. Firstly thanks to Steve Koren for  SKsh,  and
  277. Mike Meyer et. al. for Mg3. I  was  sorry  to
  278. hear  that  Mike  Meyer  has  dropped   Amiga
  279. support for this  program.  If  your  reading
  280. this Mike, how about releasing whatever  beta
  281. it was you had got up to before  making  this
  282. decision.
  283.  
  284. Thanks must also  go  to  Nico  François  for
  285. reqtools.library,  the  authors   of   iff2c,
  286. Gauthier  Groult  and  Jean  Michel  Forgeas,
  287. and to Jaba Development for GadToolsBox,  the
  288. program used to generate the screen menus.
  289.  
  290. Of course, all the people who collaborated to
  291. make GNU Chess what it is today deserve  most
  292. credit.
  293.  
  294.  
  295. Distribution + Contact
  296. ---------------------
  297.  
  298. AGC is freely-redistributable,  but  I  am  a
  299. poor student and so not averse  to  voluntary
  300. contributions :).
  301.  
  302. Anyway, I would like to hear from you if  you
  303. like AGC, and especially if you find  a  bug.
  304. Also, if you make any  changes  to  AGC,  I'd
  305. appreciate  being  kept   informed   if   you
  306. distribute it. There should be no  commercial
  307. gain for  distribution  of  this  version  or
  308. others that you may make. Disk libraries  and
  309. P.D. companies that  charge  only  a  nominal
  310. amount to cover costs are  welcome  to  carry
  311. AGC on their lists. Magazines should  request
  312. permission from the  F.S.F.  if  they  intend
  313. carrying AGC on a cover-disk - I'm  not  sure
  314. what the legalities are.
  315.  
  316. You can contact me by postal mail at:
  317.  
  318. Martin W. Scott,
  319. 23, Drum Brae North,
  320. Edinburgh, EH4 8AT
  321. United Kingdom.
  322.  
  323. or by email: mws@castle.ed.ac.uk  Note   that
  324. I'll be making a transition to a new  account
  325. in early October '92, so if any mail bounces,
  326. please try again a couple of weeks later.  If
  327. it still bounces, then I've been allocated  a
  328. different name, so try postal mail.
  329.  
  330. Thank you for reading and enjoy!
  331.  
  332. Martin Scott.
  333.  
  334.  
  335.  
  336.  
  337.  
  338.